// $Id$
// Licensed under Apache License Version 2.0
// See: http://www.apache.org/licenses/LICENSE-2.0.html
package de.servicezombie.tcmdb.rest.service;

import javax.ws.rs.Consumes;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;

import de.servicezombie.tcmdb.rest.vo.WsSoftwarebug;

/**
 * <b>Examples</b> 
 * <pre>
 *  GET    /softwarebugs/by-system/bugzilla/by-id/0815/details.xml  
 * </pre>
 * 
 * @author ChKa
 * @see WsSoftwarebug
 */
@Path("/softwarebugs")
@Consumes({ "test/json", "application/json", "test/xml", "application/xml" })
@Produces({ "test/json", "application/json", "test/xml", "application/xml" })
public interface SoftwarebugService {

	/**
	 * Get a descriptive text about a bug entry from a remote system
	 * @throws IllegalArgumentException if system is not supported
	 * @response not defined
	 */
	/* ChKa TODO define return value (Oct 16, 2011) */
	@GET
	@Path("/by-system/{bugSystem}/by-id/{bugId}/details") 
	void getDetails(@PathParam("bugSystem") String system, @PathParam("bugId") String id)
			throws IllegalArgumentException;

}
